反射 API

1. 概述

反射（Reflection）是 PHP 中一个强大的工具，允许程序在运行时检查和操作类、接口、函数和方法的内部结构。通过反射 API，开发者可以动态地获取类的信息、调用方法、访问属性，甚至修改类的行为。

反射 API 在许多高级 PHP 应用中非常有用，尤其是在框架开发、插件系统、依赖注入容器等场景中。

2. 反射 API 的基本概念

2.1 反射类

PHP 提供了多个反射类，用于不同的反射操作：

• ReflectionClass：用于反射类和对象。
• ReflectionMethod：用于反射类的方法。
• ReflectionFunction：用于反射函数。
• ReflectionParameter：用于反射方法或函数的参数。
• ReflectionProperty：用于反射类的属性。
• ReflectionExtension：用于反射 PHP 扩展。

2.2 反射的基本用法

反射的基本用法是通过创建反射类的实例，然后调用其方法来获取信息。

class Example {
    public $publicVar = 'Public Variable';
    private $privateVar = 'Private Variable';

    public function publicMethod() {
        return 'Public Method';
    }

    private function privateMethod() {
        return 'Private Method';
    }
}

// 创建 ReflectionClass 实例
$reflector = new ReflectionClass('Example');

// 获取类的所有方法
$methods = $reflector->getMethods();
foreach ($methods as $method) {
    echo $method->getName() . "\n";
}

// 获取类的所有属性
$properties = $reflector->getProperties();
foreach ($properties as $property) {
    echo $property->getName() . "\n";
}

3. 反射 API 的常见应用

3.1 获取类的信息

通过 ReflectionClass，可以获取类的名称、命名空间、父类、接口等信息。

$reflector = new ReflectionClass('Example');

echo "Class Name: " . $reflector->getName() . "\n";
echo "Namespace: " . $reflector->getNamespaceName() . "\n";
echo "Parent Class: " . $reflector->getParentClass()->getName() . "\n";
echo "Interfaces: " . implode(', ', $reflector->getInterfaceNames()) . "\n";

3.2 调用私有方法

反射 API 允许你调用类的私有方法，这在某些情况下非常有用。

$reflector = new ReflectionClass('Example');
$instance = $reflector->newInstance();

$method = $reflector->getMethod('privateMethod');
$method->setAccessible(true);

echo $method->invoke($instance); // 输出: Private Method

3.3 获取和设置属性值

反射 API 还可以用于获取和设置类的私有属性。

$reflector = new ReflectionClass('Example');
$instance = $reflector->newInstance();

$property = $reflector->getProperty('privateVar');
$property->setAccessible(true);

echo $property->getValue($instance) . "\n"; // 输出: Private Variable
$property->setValue($instance, 'New Private Value');
echo $property->getValue($instance) . "\n"; // 输出: New Private Value

4. 实践练习

4.1 练习：动态调用类方法

编写一个 PHP 脚本，使用反射 API 动态调用一个类的所有公共方法，并输出方法的返回值。

class Calculator {
    public function add($a, $b) {
        return $a + $b;
    }

    public function subtract($a, $b) {
        return $a - $b;
    }

    public function multiply($a, $b) {
        return $a * $b;
    }

    public function divide($a, $b) {
        return $a / $b;
    }
}

$reflector = new ReflectionClass('Calculator');
$instance = $reflector->newInstance();

$methods = $reflector->getMethods(ReflectionMethod::IS_PUBLIC);
foreach ($methods as $method) {
    if ($method->isConstructor()) {
        continue;
    }
    echo $method->getName() . ": " . $method->invoke($instance, 10, 5) . "\n";
}

4.2 练习：动态创建对象

编写一个 PHP 脚本，使用反射 API 动态创建一个类的实例，并设置其私有属性。

class Config {
    private $apiKey = 'default_key';

    public function getApiKey() {
        return $this->apiKey;
    }
}

$reflector = new ReflectionClass('Config');
$instance = $reflector->newInstance();

$property = $reflector->getProperty('apiKey');
$property->setAccessible(true);
$property->setValue($instance, 'new_api_key');

echo $instance->getApiKey(); // 输出: new_api_key

5. 总结

反射 API 是 PHP 中一个非常强大的工具，允许开发者在运行时动态地检查和操作类的内部结构。通过反射，你可以获取类的信息、调用私有方法、访问私有属性，甚至动态创建对象。

反射 API 在框架开发、插件系统、依赖注入容器等高级应用中非常有用。虽然反射 API 功能强大，但在使用时应注意性能问题，避免在性能敏感的代码中过度使用反射。

通过本教程的学习，你应该已经掌握了反射 API 的基本用法和常见应用场景。接下来，你可以尝试在实际项目中应用反射 API，进一步提升你的 PHP 编程技能。